SuiteQL Query Tool 2026.01

Welcome, Beta Testers!

Thank you for taking the time to test the new SuiteQL Query Tool. This version includes a complete UI overhaul, powerful AI-powered features, and numerous improvements to make querying NetSuite data easier than ever.

Your feedback is invaluable in helping us identify bugs, usability issues, and opportunities for improvement before the public release.

Getting Started

Installation

1. Upload the script file to your NetSuite File Cabinet (e.g., SuiteScripts/SuiteQL/)
2. Create a new Suitelet script record pointing to the uploaded file
3. Deploy the script with appropriate audience permissions
4. Access the tool via the deployment URL

First Launch

When you first open the tool, you'll see:

• A sample SELECT query in the editor
• The toolbar with all available actions
• An empty results panel below the editor
• A collapsible history sidebar (may be hidden by default)

Try running the sample query by clicking Run Query or pressing Ctrl+Enter (or Cmd+Enter on Mac).

AI Configuration

Many of the new features are powered by AI. To use them, you'll need to configure an API key from either Anthropic (Claude) or OpenAI (GPT).

Setup Steps

1. Click the AI button in the toolbar
2. Click the gear icon to open AI Settings
3. Select your provider (Anthropic or OpenAI)
4. Enter your API key
5. Choose a model (Claude Sonnet 4 or GPT-4o recommended)
6. Optionally check "Remember API key" to persist it
7. Click Save

Get an API Key

Provider	Where to Get Key
Anthropic (Claude)	console.anthropic.com
OpenAI (GPT)	platform.openai.com/api-keys

Features to Test

Please test each of these core features and note any issues you encounter.

Editor Features

• Syntax Highlighting

  SQL keywords, strings, and numbers should be color-coded
• Auto-Complete

  Press Ctrl+Space to trigger suggestions for tables and columns
• Text Selection

  Double-click to select a word, triple-click for line, Cmd+A to select all
• Format Query

  Click Format or press Ctrl+Shift+F to auto-format SQL
• Query Parameters

  Use {{variable}} syntax - you should be prompted for values when running
• Drag & Drop Import

  Drag a .sql file onto the editor to import it

Results Features

• View Modes

  Toggle between Table, DataTable, and JSON views
• Row Details

  Click any row to see full details in a popup
• Column Reordering

  Drag column headers to rearrange them
• Column Pinning

  Use Options to pin first 1-3 columns while scrolling
• Column Statistics

  Enable in Options to see SUM, AVG, MIN, MAX for numeric columns
• Results Maximized

  Press Shift+R to hide editor and maximize results
• Export

  Test Excel (.xlsx), CSV, JSON exports and Copy to clipboard

UI Features

• Dark Mode

  Toggle the theme using the moon/sun icon in the toolbar
• Focus Mode

  Click the expand arrows to hide NetSuite chrome
• Query History

  Check the sidebar for previously run queries
• Query Library

  Browse pre-built queries in the Query Library
• Query Sharing

  Use Share to generate a URL containing your query

AI Features Checklist

These are the new AI-powered features. Please test each one thoroughly.

AI Query Generator

• Basic Query Generation

  Click AI button, type "Show me all active customers" - verify a query is generated
• Insert Query Button

  After AI generates SQL, verify "Insert Query" and "Copy" buttons appear below the code block
• Conversation History

  Send follow-up messages like "now exclude inactive ones" - AI should remember context
• Auto-Execute

  Enable "Auto-execute query" checkbox, generate a query, verify it runs automatically
• Clear Conversation

  Click trash icon to clear - verify conversation resets

Natural Language Query Bar

• Toggle Bar

  Click "Ask" button to show/hide the natural language bar above the editor
• Generate Query

  Type a description and press Enter or click Generate
• Focus Behavior

  Click in the input field - cursor should stay there (not jump to editor)

Explain Query

• Basic Explanation

  Write a complex query, click Explain - verify AI provides clear breakdown
• Close Panel

  Verify the X button closes the explanation panel

Validate Query

• Missing WHERE Warning

  Write SELECT * FROM customer, click Validate - should warn about missing WHERE
• Run Anyway

  After validation warning, click "Run Anyway" - query should execute

Query Optimization

• Slow Query Banner

  Run a query that takes >5 seconds - optimization banner should appear
• Optimize Button

  Click Optimize - AI modal should open with optimization suggestions

Tables Reference (AI Features)

• Open Tables Reference

  Click "Tables" button - should open in new window
• AI Find Mode

  Toggle to "AI Find", search "customer payment history" - AI should suggest tables
• Ask AI About Table

  Select a table, try the preset questions (What is this table used for?, etc.)
• Generate Query from Selection

  Select columns using checkboxes, click "Generate Query"
• Focus Mode

  Click expand arrows to hide NetSuite chrome in Tables Reference

Browser-Specific Notes

Safari on macOS Safari

We've implemented specific fixes for Safari. Please verify these work correctly:

• Select All (Cmd+A) - Should select all text in the editor
• Double-click - Should select the word under cursor
• Click and drag - Should select text properly
• AI Modal text selection - Should be able to select text in AI responses without affecting the editor

Chrome / Edge / Firefox All Browsers

These browsers should work without any special handling. Please report if you encounter any browser-specific issues.

Mobile Browsers

The tool is designed for desktop use. Mobile testing is not a priority for this beta, but feel free to note any observations.

Keyboard Shortcuts

Please test these shortcuts work correctly (use Cmd instead of Ctrl on Mac):

Action	Shortcut	Test
Run Query	Ctrl+Enter	Should execute current query
Format Query	Ctrl+Shift+F	Should format/indent SQL
Save Query	Ctrl+S	Should open save dialog
Select All	Ctrl+A	Should select all text in editor
Auto-Complete	Ctrl+Space	Should show suggestions
Maximize Results	Shift+R	Should hide editor, show full results
Exit Maximized/Focus	Escape	Should restore normal view
Show Shortcuts	?	Should show shortcuts modal

Known Limitations

These are known limitations in the current beta:

• AI API Keys - Each user must configure their own API key. There's no centralized key management yet.
• Query Timeout - Very long-running queries may timeout based on NetSuite governance limits.
• Large Result Sets - Exporting very large result sets (10,000+ rows) may be slow.
• Tables Reference - Opens in a new window; doesn't share state with main tool.
• Mobile Support - Not optimized for mobile devices.

Thank You!

We truly appreciate you taking the time to test the SuiteQL Query Tool. Your feedback directly shapes the final release and helps the entire NetSuite community.

Happy querying!

- Tim